home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / baswind2.arc / READ.ME < prev    next >
Encoding:
Text File  |  1986-12-12  |  5.2 KB  |  113 lines
  1.  
  2.  
  3.                               Update to BASWIND2
  4.  
  5.  
  6. In this file you will find corrected versions of the modules in BASWIND2.ARC,
  7. including:
  8.  
  9.     MAKEWIND
  10.     NEWSCRN (SAVESCRN and RESTSCRN)
  11.     SCROLL
  12.     FASTPRT
  13.  
  14. As you perhaps may have discovered, there were some serious and not-so-serious
  15. bugs in this original distribution package. My thanks to everyone who helped
  16. me track down and solve the problems with this initial package.
  17.  
  18. CHANGES IN THIS RELEASE
  19.  
  20. Module NEWSCRN:
  21.  
  22. This module had the most serious problem - it would not work correctly with
  23. monochrome or Hercules cards. Blame this on me - I don't have a monochrome
  24. card so I never tested it. However, this version HAS been tested on a mono
  25. monitor and has been verified to work. As part of the fix, the names of the
  26. called procedures have been changed for SCRNSAVE and SCRNREST to SAVESCRN
  27. and RESTSCRN. This will insure that you don't inadvertently get the old
  28. versions linked into your corrected programs. Also, as shown in the new doc-
  29. umentation file included in this release, the calling convention is somewhat
  30. different. Now there are two integers to be passed in the CALL: the first
  31. tells the routine whether to test retrace status when using a color monitor
  32. to prevent snow, and the second passes the location of the first element in
  33. the array obtained by the VARPTR function. A typical call would be as follows:
  34.  
  35.                 10 DIM SCRNDATA%(2000):'4000 bytes, holds one screen
  36.                  .
  37.                  .
  38.                  .
  39.                  .
  40.  
  41.                 80 NOTEST%=0
  42.                 90 FIRST%=VARPTR(SCRNDATA%(0))
  43.                100 CALL SAVESCRN(NOTEST%,FIRST%)
  44.  
  45. The NOTEST% parameter is used primarily for the IBM CGA adapter. When you set
  46. this variable to 0, testing is forced; which will eliminate snow on the screen
  47. but will also slow down operation somewhat. Non-IBM color cards and the EGA do
  48. not require this testing, so if you set the variable to 1, testing will be
  49. bypassed and the screen writes will be as fast as possible. Regardless of the
  50. value of this variable, a monochrome system will be automatically detected and
  51. testing will be defeated since it is not required.
  52.  
  53.  
  54. Module MAKEWIND:
  55.  
  56. There have been no changes to this module; however, I have found that when the
  57. routine is compiled, it requires the /D switch on the compiler to generate
  58. error-checking code in order to work correctly. I discovered that when the /D
  59. option was omitted, when a 'growing' window was requested, the growing effect
  60. was not properly executed. Instead of growing from the center outward, it in-
  61. stead grew from the right-hand side to the left! I still don't know what is
  62. causing this, so for this reason I am including in this release the source
  63. code to this and the SCROLL modules so that you BASIC jocks that are more
  64. knowledgeable than I am can see what is going on and perhaps find the culprit.
  65. Adding the /D switch makes the size of the module considerably larger; so there
  66. is some benefit to leaving it off if the problem can be corrected. If anyone
  67. finds out what the problem is, please post me a message on Compuserve (ID #
  68. 72456,2325) or GEnie (Address: D.EVERS) and I'll spread the word around.
  69.  
  70. Module SCROLL:
  71.  
  72. No changes in this release.
  73.  
  74. Module USERLIB2:
  75.  
  76. This is an addition to this release of BASWIND. In the first release, I decided
  77. not to distribute a User Library form of these routines because of the fact that
  78. they required the presence of the USERLIB module distributed with QuickBASIC.
  79. Since I assume this module is copywrited by Microsoft, I chose to let the
  80. user create his own User Library at his end using his copy of USERLIB. However,
  81. a problem arose in that because of the fact that the MAKEWIND module was com-
  82. piled using the /D switch, it included some code linked in from the BRUN20.LIB
  83. module which made reference to the module ABSOLUTE. The problem was that
  84. USERLIB.OBJ also includes a module ABSOLUTE, which resulted in a Duplicate
  85. Module Name error occuring during the BUILDLIB procedure. As far as I was able
  86. to determine, this error was more of a warning nature than a severe one, as I
  87. simply ignored it and used the library anyway. (By the way, there are no calls
  88. to the module ABSOLUTE anywhere in BASWIND). However, this proved to be dis-
  89. turbing to many people (and rightly so); so I have taken a step of questionable
  90. legality by including in this package a module USERLIB2; which is the Quick-
  91. BASIC USERLIB.ASM edited to remove the ABSOLUTE procedure and reassembled. I
  92. don't really believe this presents much of an infringement problem; since
  93. everyone who buys QuickBASIC gets a copy of USERLIB and it is of no use to
  94. anyone without QuickBASIC. Anyway, using this USERLIB2 module instead of the
  95. original USERLIB will correct once and for all the Duplicate Module Name
  96. problem.
  97.  
  98.  
  99. I sincerely apologize for any inconvenience these problems might have caused
  100. anyone using BASWIND2; and I hope that these corrected programs solve any
  101. problems you might have. If not, please do not hesitate to leave me a note
  102. on Compuserve or GEnie; or to drop me a line at my home address given in the
  103. documentation file.
  104.  
  105.  
  106.  
  107. Thank you for your support,
  108.  
  109.  
  110. Dave Evers
  111.  
  112.  
  113.